home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / DAVISON / MUSHROOM / !MUSHRooms / !Help next >
Text File  |  1996-01-31  |  5KB  |  100 lines
  1. A fairly simple (though not totally small :) chat server program to be
  2. run over one of the Internet stacks.
  3.  
  4. Anyone familiar with the MU* concept should find this fairly 'normal' in
  5. use. It draws most of it's ideas from MUSH (TinyMUSH, in fact) as that's
  6. what I use, and that's the group of people I created it to chat with.
  7. Thus it works with telnet connections and talking is done using the mush
  8. system (lines starting with : ; or " are 'poses', simplest is really to
  9. try them and see. And 'spoofing' can be acheived via \\. It's presumed
  10. that it's for 'friends' so there's no nospoof flag, at this stage.) and
  11. all commands (except three) begin with an '@'. The exceptions are 'WHO'
  12. which gives a list of everyone connected, 'QUIT' which drops your
  13. connection, and 'l' (or 'lo') which does a look - shows you the name of
  14. your room, who's there, and how long they've been on/idle. (see @help
  15. when connected, or text.help)
  16.  
  17. It has a vague concept of 'rooms' (defined in the Resrouces.Rooms file,
  18. see that for sytanx details). Currently the program will listen on
  19. multiple ports, and each port is considered a room. You cannot move
  20. between rooms at the moment, and no communication is possible between
  21. them.
  22.  
  23. To just make it go, edit the Resources.Rooms file and run it.
  24. Telnet into whichever port you choose :)
  25.  
  26. Options availble on the command line are:
  27. -loglevel <num>    Integer that says what things should be written to the
  28.         logfile. A value of 0 will turn logging off.
  29.         The number to use can be built up from the following
  30.         table
  31.           Bit    Things logged
  32.             0    Startup, shutdown, fatal errors
  33.             1    recoverable errors
  34.             2    Initialisation success
  35.             3    Net connects/disconnects (including socket
  36.             initialisation stuff)
  37.             4    Player connect/disconnects
  38.             5    Memory claim/free
  39.             6    Unknown commands
  40.             7    Known commands
  41.             8    Informational messages that probably have no use
  42.             31    Message of use for debugging only (really)
  43.         My suggested log level value for normal use would be 95
  44.          - startup; recoverable; initialisation; net & player
  45.            conns; unknown commands.
  46.         Though changing to suit the speed of the storage is a
  47.            good idea, it can take a while to log things (no, the
  48.            logging isn't at all efficient.)
  49.  
  50. -config <path>    By default it looks for things on MUSHRooms:, this can
  51.            change that at runtime.
  52. -noicon        Prevents creation of iconbar icons and windows. There is
  53.            currently no way of changing this once the program is
  54.            running (it can, of course, be quit from the task
  55.            manager)
  56.  
  57. Admin commands:
  58. @admin        Much like 'WHO' but includes information about each
  59.            player on the next line as well. The second line has
  60.            the form "<hostname> <pending input>/<pending output>
  61.            <local socket handle>|<port number>"
  62. @shutdown    Shuts the application down, closing all ports.
  63.  
  64. When the application has an icon on the icon bar, a menu is available
  65. that lists all active connections, and allows a window to be opened on
  66. each. The box shows everything the @admin command does, but allows the
  67. local user to change the name, doing or hosts fields. It also allows
  68. them to boot that user, or to shutdown the entire chat system (which can
  69. also be done by 'quit')
  70.  
  71.  
  72. I _think_ that's it. Primarily I wrote this 'cause we (me an' my
  73. friends) wanted to be able to chat mainly lag free and/or when the usual
  74. MUSH's we frequent were down. We all do use it, and haven't found any
  75. faults with it really. It should, now, work on both Acorn's Internet and
  76. FreeNet (I'm running it on a RiscPC with FreeNet and a Slip connection -
  77. remote users come in over the modem, I connect from the local machine,
  78. and the local ethernet (we have access running), depending on mood and
  79. availablity). Whether it is of any use, or interest to you largely
  80. depends on what you need. It'll handle most things that TinyMUSH will in
  81. terms of I/O (except there's a 2k, or so, limit on poses, compared to
  82. Tiny's 4k). It has had a fair bit of 'field' testing, the intial version
  83. appeared about 6 weeks ago, I guess, and it's been fairly reliable. If
  84. you use it, cool. I'm interested in any suggestions or bug reports, if
  85. anyone .does. have any of either. Due to the nature of the purpose of
  86. the program, development relies entirely on the whims of me and my
  87. friends (s'the reason @doing's are there :). Thus, if you want
  88. something, ask.
  89.  
  90. #include <stddisclaimer.h>
  91. If it melts your machine or whatever, don't blame me. All i can say is
  92. that I have had no such problems.
  93.  
  94.  
  95.  
  96.  
  97.  
  98. Iff'n ya wanna find me:
  99. Email: julian@southern.co.nz
  100.